home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_hylafax.idb / usr / freeware / catman / u_man / cat1 / faxsetup.Z / faxsetup
Text File  |  2002-07-08  |  5KB  |  118 lines
  1. FAXSETUP(${MANNUM1_8})               FAXSETUP(${MANNUM1_8})
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        faxsetup    - setup    a machine for use with _H_y_l_a_F_A_X
  7.  
  8. SSYYNNOOPPSSIISS
  9.        $${{SSBBIINN}}//ffaaxxsseettuupp      [  --cclliieenntt  ]     [  --sseerrvveerr  ]    [  --wwiitthh--
  10.        VVAARR_[_=_v_a_l_u_e_] ]
  11.  
  12. DDEESSCCRRIIPPTTIIOONN
  13.        _f_a_x_s_e_t_u_p    is an interactive shell    script that does the nec
  14.        essary  setup work to configure a client    or server machine
  15.        for the _H_y_l_a_F_A_X software.  _f_a_x_s_e_t_u_p must    be run    on  every
  16.        _H_y_l_a_F_A_X    server    machine     before     the  software will func
  17.        tion-if a _H_y_l_a_F_A_X server     program  or  script  is  invoked
  18.        before _f_a_x_s_e_t_u_p is run, the command will    abort with a mes
  19.        sage that says to run _f_a_x_s_e_t_u_p.    _f_a_x_s_e_t_u_p  may  optionally
  20.        be  run on a _H_y_l_a_F_A_X client machine to verify the configu
  21.        ration of the software.
  22.  
  23.        By default _f_a_x_s_e_t_u_p checks a machine for     use  both  as    a
  24.        _H_y_l_a_F_A_X     client      and    server.      Client-specific  checks
  25.        include:
  26.  
  27.      the installation of client programs and data,
  28.  
  29.      the installation of the Adobe Font Metric (AFM)  infor
  30.       mation  files     used by the _H_y_l_a_F_A_X text formatting sup
  31.       port.
  32.  
  33.        Server-specific checks include:
  34.  
  35.      the installation of server programs and data,
  36.  
  37.      the existence of the UUCP lock    file directory,
  38.  
  39.      the installation of the TIFF software tools,
  40.  
  41.      the configuration of the  getty  programs  invoked  for
  42.       data and voice calls,
  43.  
  44.      the  pathnames     for  various  system  programs     used by
  45.       server shell scripts,
  46.  
  47.      proper    support    for FIFO special files,
  48.  
  49.      proper    installation of    a POSTSCRIPT RIP,
  50.  
  51.      definition of a ``fax'' user,
  52.  
  53.      definitions for the ``hylafax'' and ``snpp'' services,
  54.  
  55.      startup of the    _H_y_l_a_F_A_X     server     processes:  _f_a_x_q(${MAN
  56.       NUM1_8}) and _h_f_a_x_d(${MANNUM1_8}),
  57.  
  58.      definition  of    a ``FaxMaster''    mail alias for reporting
  59.       server problems.
  60.  
  61.        For server machines _f_a_x_s_e_t_u_p also creates two  files  that
  62.        are  required  by  the  _H_y_l_a_F_A_X command scripts.     One file
  63.        contains    master configuration  parameters  and  the  other
  64.        contains     various definitions used by scripts such as _f_a_x_
  65.        _a_d_d_m_o_d_e_m(${MANNUM1_8}) that communicate with modems.
  66.  
  67. OOPPTTIIOONNSS
  68.        --cclliieenntt     Do client-specific consistency    checks.
  69.  
  70.        --sseerrvveerr     Do server-specific consistency    checks.
  71.  
  72.        --wwiitthh--VVAARR_[_=_v_a_l_u_e_]
  73.          Override the default definition for the configu
  74.          ration     parameter named VVAARR; optionally specify
  75.          ing a new _v_a_l_u_e (if no    value is  specified  then
  76.          ``yes''  is  used).   This  option is especially
  77.          useful    to override the    default    settings for  the
  78.          POSTSCRIPT  interpreter  package  to  use  (e.g.
  79.          ``-with-PS=dps''),   the   spooling    directory
  80.          (``-with-DIR_SPOOL=/mumble''),      the    directory
  81.          where the tool     applications  of  TIFF     software
  82.          distribution     are    located       (``-with-TIFF
  83.          BIN=/usr/freeware''), etc.  A complete     list  of
  84.          the  possible parameters can be found by looking
  85.          at the    contents of the     _f_a_x_s_e_t_u_p  shell  script;
  86.          many  of these    configuration parameters are also
  87.          described in the HTML documentation
  88.  
  89.        --hheellpp     Print a help message and terminate.
  90.  
  91.        --qquuiieett     Do not    print verbose messages to the terminal.
  92.  
  93.        --vveerrbboossee     Print    informative  messages  to  the     terminal
  94.          (default).
  95.  
  96. BBUUGGSS
  97.        _f_a_x_s_e_t_u_p     does not query    a modem    to find    out its    capabili
  98.        ties when invoking the _f_a_x_m_o_d_e_m program to setup    a  server
  99.        in  a  send-only    configuration; it may be necessary to run
  100.        _f_a_x_m_o_d_e_m    manually.
  101.  
  102. FFIILLEESS
  103.        ${SPOOL}/etc/setup.cache       master configuration    parameters
  104.        ${SPOOL}/etc/setup.modem       modem-related configuration support
  105.  
  106.        Consult _h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MANNUM4_5}) for    a  complete  dis
  107.        cussion of the structure    and content of the spooling area.
  108.  
  109. SSEEEE AALLSSOO
  110.        _h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MANNUM4_5}),        _h_y_l_a_f_a_x_-_c_o_n_f_i_g(${MAN
  111.        NUM4_5}), _f_a_x_q(${MANNUM1_8}), _f_a_x_g_e_t_t_y(${MANNUM1_8}), _f_a_x_
  112.        _m_o_d_e_m(${MANNUM1_8}),         _f_a_x_c_o_n_f_i_g(${MANNUM1_8}),
  113.        _f_a_x_s_e_n_d(${MANNUM1_8})
  114.  
  115.  
  116.  
  117.              August    26, 1996   FAXSETUP(${MANNUM1_8})
  118.